home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / fdtr201.arc / FDTRANS.DOC next >
Text File  |  1992-01-15  |  7KB  |  197 lines
  1. Name:              FDTRANS.EXE
  2.  
  3. Version:           2.0
  4.  
  5. What it does:      Shows a lot of statistical analyses from FD's INBOUND
  6.                    and OUTBOUND.HIS files.
  7.  
  8. What you need:     Frontdoor 2.x (does not correctly work with earlier
  9.                    Versions)
  10.  
  11. How it works:      Good news: there's no configuration necessary!
  12.                    Everything needed by FdTrans is taken from the SETUP.FD
  13.                    file, which is located through the FD environment
  14.                    variable.
  15.  
  16.                    Allthogh this document is rather short, everything
  17.                    seems to be said I think :-)
  18.  
  19.                    By calling FdTrans without any parameters it gives
  20.                    you all the statistics. Any output can be redirected
  21.                    to a file.
  22.  
  23.                    Typing "FdTrans ? <return>" gives you a short parameters
  24.                    overview:
  25.  
  26. FDTrans v2.0.002ß, (c) W. Krietsch 1991
  27.  
  28. Syntax:    FDTRANS [ Options ] [ > OutFile ]
  29.  
  30.   Options:
  31.  
  32.     A      address to process (4d, wildcards '*' allowed; default: all)
  33.     I      process INBOUND.HIS
  34.     O      process OUTBOUND.HIS (default: both)
  35.     Fdate  first date to eval (yy-mm-dd)
  36.     Tdate  last date to eval (yy-mm-dd)
  37.     Ddays  number of (last) days to eval
  38.     Rx     reporttype, where x is
  39.            C (per call)
  40.            D (per day)
  41.            T (totals)
  42.            S (summary and statistic)
  43.            A (report by address)
  44.            U (usage analysis)
  45.     Gx     graphic analysis of
  46.            I incoming calls
  47.            O outgoing calls
  48.            T incoming+outgoing calls
  49.    V       no virus check.
  50.  
  51.   * By default, all reports are and graphics generated.
  52.  
  53.  
  54.  
  55. Options:          Any of the folowing Options could be specified in the form
  56.                    /<Option> - but there's no need for the slash
  57.  
  58.               a) Filteroptions (selecting a specific range to analyze)
  59.  
  60.  
  61.                  A<address>   <address> may be any valid Fidonet-address
  62.                               Zone:Net/Node[.Point]. You may use the "*" as
  63.                               a wildcard:
  64.  
  65.                               2:245/*
  66.                               2:245/60.*
  67.                               1:*/*
  68.  
  69.                               etc.
  70.  
  71.                               The default is of course *:*/*.*.
  72.  
  73.                  I            only analyze INBOUND.HIS
  74.                  O            only analyze OUTBOUND.HIS
  75.  
  76.                               If you are a point and don't have an
  77.                               INBOUND.HIS, you should always specify the
  78.                               "O" option if you dont't want to be
  79.                               bothered by an errormessage.
  80.  
  81.                  F<date>      first valid date
  82.                  T<date>      last valid date
  83.                  D<days>      number of days to analyze
  84.  
  85.                               Any date must be specified in the form
  86.                               "YY-MM-DD".
  87.  
  88.  
  89.               b) Options for selecting analyzing functions
  90.  
  91.                  Rx           selects a report-type, where "x" is one
  92.                               of the following:
  93.  
  94.                       C       one line for each call
  95.                       D       one line for each day
  96.                       T       one line for totals.
  97.  
  98.                  These reports may be combined, i. e. "FdTrans RC RD RT"
  99.                  would give something like:
  100.  
  101. H> Date     Time  Address              Sent      Rcvd  Connect   CPS   Cost
  102. C> 91-09-21 00:28 2:242/37           304657       271 00:05:001016.4   0.00
  103. [...]
  104. C> 91-09-21 00:41 2:241/5806         216598      2159 00:02:231529.8   0.23
  105. C> 91-09-21 00:53 2:245/60.15        190673       550 00:11:41 272.8   0.00
  106. D> 91-09-21       [  23]            3420888     61891 02:49:33 342.4   0.00
  107.  
  108. T> 91-09-21       [ 452]           53704655   1127778 40:45:57 373.6  14.26 
  109.  
  110.                               As you see, in the "D>" and "T>" lines (these
  111.                               tags may be useful for filetering output) the
  112.                               address entry is replaced with the number of
  113.                               calls.
  114.  
  115.                               Note that FdTrans does NOT calculate any
  116.                               phone cost by himself yet - it just takes
  117.                               the data from the .HIS files!
  118.  
  119.                       S       very interesting summary: "FdTrans RS" gives
  120.                               you
  121.  
  122. S> Summary:
  123. S>
  124. S> 91-09-11 to 91-09-21 (11 Day(s))
  125. S>
  126. S>                 Total       Day     Month       Year      Call
  127. S> Connects:         452      41.1    1232.7    14792.7      ****
  128. S> Time (h):       40.77      3.71    111.18    1334.15      0.09
  129. S> Sent:        53704655   4882241 146467241 1757606891    118816
  130. S> Received:     1127778    102525   3075758   36909098      2495
  131. S> Sent+Rcvd:   54832433   4984767 149542999 1794515989    121311
  132. S> Cost:           14.26      1.30     38.89     466.69      0.03
  133. S>
  134. S> Average CPS: 373.63
  135.  
  136.  
  137.  
  138.                       A       Analyse anything addresswise
  139.  
  140.  
  141.                       U       Analyse system usage
  142.  
  143.                  Gx           Graphical analysis - "x" means
  144.  
  145.                       I       INBOUND
  146.                       O       OUTBOUND
  147.                       T       Total (INBOUND + OUTBOUND)
  148.  
  149.                    Just try it to see what it does :-)
  150.  
  151.  
  152. History:           v1.0  : first release
  153.  
  154.                    v1.1  : some bugfixes
  155.  
  156.                    v2.0  : transformed to FD 2.x, many more posibilities
  157.  
  158.                    v2.01 : some changes in the output format, which was
  159.                            not safe for large numbers before (thanks to
  160.                            Dieter Soltau, 2:241/0 :-). Also some cosmetic
  161.                            changes...
  162.                            FdTrans now checks itself for illegal code-
  163.                            modifications, so it should be safely
  164.                            protected against viruses!!! When there's no
  165.                            error found, you won't even notice it - but
  166.                            if there's a virus, the program aborts with
  167.                            an error message and exitcode 17! If you know
  168.                            for sure that your system is "clean", you can
  169.                            turn off the virus check with the "V"
  170.                            parameter.
  171.  
  172. Legal stuff:       This program is ditributed as shareware. If you use
  173.                    it, you should register it. To do so, just take US$
  174.                    10 or German DM 15, put it in an envelope and send it
  175.                    to:
  176.  
  177.                       Wolfgang Krietsch
  178.                       Kreuzstraße 1
  179.                       5840 Schwerte
  180.                       Germany
  181.  
  182.  
  183.  
  184.                    I guarantee that this program will occupy space on
  185.                    your hard disk - nothing more.
  186.  
  187.                    Suggestions, bug reports and questions may be sent to
  188.  
  189.                      Wolfgang Krietsch, 2:245/60.14@fidonet
  190.  
  191.  
  192. Have fun!
  193.  
  194.   Wolfgang Krietsch
  195.  
  196.  
  197.